home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / comm2 / mmhndltc.lha / MM / Docs / MM_HandleTicFiles.doc < prev   
Text File  |  1996-04-21  |  7KB  |  252 lines
  1.  
  2.  
  3.  
  4.                                   7   7  7   7
  5.                                   77 77  77 77
  6.                                   7 7 7  7 7 7
  7.                                   7   7  7   7
  8.                                   7   7  7   7
  9.  
  10.  
  11.  7   7   7   7   7 7777  7     77777 77777 777  777  77777 777 7     77777  7777
  12.  7   7  7 7  77  7 7   7 7     7       7    7  7   7 7      7  7     7     7
  13.  77777 77777 7 7 7 7   7 7     7777    7    7  7     7777   7  7     7777   777
  14.  7   7 7   7 7  77 7   7 7     7       7    7  7   7 7      7  7     7         7
  15.  7   7 7   7 7   7 7777  77777 77777   7   777  777  7     777 77777 77777 7777
  16.  
  17.  
  18.                            7   7   77        7  7777
  19.                            7   7  7  7      77  7
  20.                            7   7  7  7     7 7  777
  21.                             7 7   7  7       7     7
  22.                              7     77   7    7  777
  23.  
  24.  
  25.  
  26.  
  27.                            (C)  1996  Kent B. Hansen
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  1. Introduction
  34.  ===============
  35.  
  36.   1.1 Legal stuff
  37.   ---------------
  38.  
  39.    MM_HandleTicFiles is an Arexx-script for Mail Manager by Pino Aliberti.
  40.  
  41.    The programs and files in this distribution are freely distributable, but are
  42.    also Copyright (c) Kent B. Hansen.  They may be freely distributed as long as
  43.    no more than a nominal fee is charged to cover time and copying costs.
  44.  
  45.    No commercial usage is  permitted without  written permission from the author
  46.    Everything in this distribution must be kept together, in original unmodified
  47.    form.
  48.  
  49.  
  50.    MM_HandleTicFiles is mailware :-).  This means if you use it, please write me
  51.    a short mail.  You know, it is frustrating to write programs and there are no
  52.    responses from the users if they like it or not...
  53.  
  54.  
  55.    Accepting    these   few   points   is   the   only   condition   for   using
  56.    MM_HandleTicFiles...
  57.  
  58.  
  59.  
  60.    =============================================================================
  61.    The  author is not responsible for any problems caused by using this program!
  62.    =============================================================================
  63.  
  64.  
  65.  
  66.   1.2 General stuff
  67.   -----------------
  68.  
  69.    I  am  not  the  best  in  writing  doc.  This docs are a bit short I have to
  70.    appolognize, but I hope you'll understand it anyway...  Especially my English
  71.    and the typo's ;-)
  72.  
  73.    If there is  anybody out there  who is able to &  wants translate the docs to
  74.    his own language, please do so and send them to me! I'll add them to the next
  75.    release.
  76.  
  77.  
  78.  
  79.  
  80.  
  81.   1.3 Author
  82.   ----------
  83.  
  84.    If  you  have  suggestions  or remarks about this program, or if you find any
  85.    bugs, please let me know.
  86.  
  87.  
  88.    Contacting the author:
  89.  
  90.      Internet .. :  kbh@imada.ou.dk
  91.      FidoNet ... :  2:237/30.0
  92.      AmigaNet .. :  39:140/103.0
  93.  
  94.      Snail-mail  :  Kent B. Hansen
  95.                     Niels Juels Alle 59
  96.                     DK-5250 Odense SV
  97.                     Denmark
  98.                     Tel. +45-63120212
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  2. Features
  105.  ===========
  106.  
  107.   MM_HandleTicFiles...
  108.  
  109.      ... deletes the .TIC-files before they're send to the points
  110.      ... removes the entries in the flowfiles as well
  111.      ... is configurable per point/node-number
  112.      ... supports full 5D addressing and wildcards
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  3. Installation
  119.  ===============
  120.  
  121.   1. Copy the files to the related MM:-directories.
  122.  
  123.   2. Make sure you have installed rexxsupport.library in LIBS:.
  124.  
  125.   2. Adjust the cfg to your own needs.
  126.  
  127.   3. Add it as a tickcmd in MM_ImportPlus:
  128.  
  129.          #TICKCMD   rx MM:Rexx/MM_HandleTicFiles.rexx
  130.  
  131.      or to your import-batch or whatever else you use.
  132.  
  133.  
  134.  
  135.   As    you    may    have    seen,    there's    a    second    script   called
  136.   "MM_HandleTicFiles.rexx.cmp"  included.  This is a exacltly the same script as
  137.   "MM_HandleTicFiles.rexx"   itself,   except   that   it  was  compressed  with
  138.   "CompressRexx v2.1".
  139.  
  140.   On  slow  machines, it might be useful to replace the uncompressed script with
  141.   the  compressed one because it is slightly faster...  But please test it first
  142.   with  the  uncompressed version, because if an error occurs, finding the error
  143.   due to error-reports of the compressed script is nearly impossible!
  144.  
  145.   There's  also  included  an executable version of the script.  This version is
  146.   compiled with "CompressRexx v2.1" and can be made resident.
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  4. Usage
  153.  ========
  154.  
  155.   [RX] MM_HandleTicFiles[.rexx]
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  5. Configuration
  162.  ================
  163.  
  164.  
  165.   5.1 #(NO)DEBUG
  166.   ---------------
  167.  
  168.    Enables/disables  logging  of  processed  flowfiles  and  deleted  tickfiles.
  169.    Default is #NODEBUG.
  170.  
  171.  
  172.  
  173.   5.2 #LIST <path+file>
  174.   ---------------------
  175.  
  176.    Path and name of the AmigaDOS command 'List'. Default is 'c:list'.
  177.  
  178.    
  179.  
  180.   5.3 #NODE <address>
  181.   -------------------
  182.  
  183.    5D-address  of  then node/point that don't want the tickfiles.  Wildcards are
  184.    allowed,  but  be  carefull  -  You  might  wipe  out every .TIC-file in your
  185.    outbound directory!!.
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  6. Theory of operation
  192.  ======================
  193.  
  194.   MM_HandleTicFiles  should  normally  only  be  started after you have imported
  195.   tickfiles.  So the #TICKCMD in MM_ImportPlus is a good place to start it.
  196.  
  197.   You could also start it in the aftersession, but it's only nessesary to run it
  198.   when there has been imported tickfiles..
  199.  
  200.   MM_HandleTicFiles  searches  the flowfiles of the configured nodes/points for
  201.   entries  ending  with a ".TIC".  These lines will be deleted, and the physical
  202.   file corresponding to the entry will be deleted as well.
  203.  
  204.   This  way  people  who  really  don't  need  or  want the tickfiles, can avoid
  205.   spending time and space downloading them.  :-)
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  7. Future
  212.  =========
  213.  
  214.   Ideas for the future...
  215.  
  216.      ... add or remove entries in the cfg-file with commandline options
  217.      ... option to pack all tick files into one archive
  218.      ... support for MM_HandleTicFiles in MM_AreaManager :)
  219.      ... other ideas? Please write to me!
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  8. Acknowledgements
  226.  ===================
  227.  
  228.   My girlfriend     For  tolerating me spending too much time with my Amiga, and
  229.                     just beeing wonderful and lovely!
  230.  
  231.   Pino Aliberti     For his excellent Mail Manager!
  232.  
  233.   Robert Hofmann    For good suggestions and help developing this script.
  234.                     For  all  his  excellent scripts for Mail Manager, including
  235.                     CompressRexx and MM_ImportPlus mentioned in this doc.
  236.                     For  the MM_RexxDeveloperKit v1.0 used in the making of this
  237.                     script.
  238.                     And for the 'template' for this documentation. ;)
  239.  
  240.   Frank Schnittger  For MM_AreaManager - The best AreaFix for MailManager!
  241.  
  242.  
  243.  
  244.  
  245.  
  246.                                     --O--
  247.  
  248.          Kent B. Hansen     2:237/30.0@fidonet      9:451/246.0@virnet
  249.           The TPV BBS      39:140/103.0@amiganet  kbh@imada.ou.dk
  250.  
  251.  
  252.